home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / librw / RWCollectableString.z / RWCollectableString
Encoding:
Text File  |  2002-10-03  |  8.3 KB  |  199 lines

  1.  
  2.  
  3.  
  4. RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg((((3333CCCC++++++++))))                            RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg((((3333CCCC++++++++))))
  5.  
  6.  
  7.  
  8. NNNNaaaammmmeeee
  9.      RWCollectableString - Rogue Wave library class
  10.  
  11. SSSSyyyynnnnooooppppssssiiiissss
  12.               typedef RWCollectableString String;  // Smalltalk typedef
  13.  
  14.  
  15.  
  16.               #include <rw/collstr.h>
  17.           RWCollectableString  c;
  18.  
  19.  
  20.  
  21.  
  22. DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  23.      Collectable strings.  This class is useful when strings are stored and
  24.      retrieved as RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessss, or when they are used as keys in the
  25.      "dictionary" collection classes.  Class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg inherits from
  26.      both class RRRRWWWWCCCCSSSSttttrrrriiiinnnngggg and class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee.  The virtual functions of
  27.      the base class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee have been redefined.
  28.  
  29. PPPPeeeerrrrssssiiiisssstttteeeennnncccceeee
  30.      Polymorphic
  31.  
  32. PPPPuuuubbbblllliiiicccc CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrrssss
  33.               RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg();
  34.  
  35.  
  36.      Construct an RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg with zero characters.
  37.  
  38.               RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg(const RWCString& s);
  39.  
  40.  
  41.      Construct an RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg from the RRRRWWWWCCCCSSSSttttrrrriiiinnnngggg ssss.
  42.  
  43.               RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg(const char* c);
  44.  
  45.  
  46.      Conversion from character string.
  47.  
  48.               RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg(const RWCSubString&);
  49.  
  50.  
  51.      Conversion from sub-string.
  52.  
  53.               RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg(char c, size_t N);
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg((((3333CCCC++++++++))))                            RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg((((3333CCCC++++++++))))
  71.  
  72.  
  73.  
  74.      Construct an RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg with NNNN characters (default blanks).
  75.  
  76. PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrr FFFFuuuunnnnccccttttiiiioooonnnnssss
  77.               virtual RWspace
  78.           bbbbiiiinnnnaaaarrrryyyySSSSttttoooorrrreeeeSSSSiiiizzzzeeee() const;
  79.  
  80.  
  81.      Redefined from class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee.
  82.  
  83.               virtual int
  84.           ccccoooommmmppppaaaarrrreeeeTTTToooo(const RWCollectable* c) const;
  85.  
  86.  
  87.      Redefined from class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee.  returns the result of
  88.      RRRRWWWWCCCCSSSSttttrrrriiiinnnngggg::::::::ccccoooommmmppppaaaarrrreeeeTTTToooo((((****((((ccccoooonnnnsssstttt SSSSttttrrrriiiinnnngggg****))))cccc,,,, RRRRWWWWCCCCSSSSttttrrrriiiinnnngggg::::::::eeeexxxxaaaacccctttt)))).  This compares
  89.      strings lexicographically, with case considered.  It would be possible to
  90.      define , for instance, CCCCaaaasssseeeeFFFFoooollllddddeeeeddddSSSSttttrrrriiiinnnngggg which did comparisons ignoring
  91.      case.  We have deliberately left this as an exercise for two reasons:
  92.      Because it is both easy to do and not universally needed; and because the
  93.      presence of both RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnnggggssss and such a CCCCaaaasssseeeeFFFFoooollllddddeeeeddddSSSSttttrrrriiiinnnngggg in any
  94.      kind of sorted collection has the potential for very confusing behavior,
  95.      since the result of a comparison would depend on the order in which the
  96.      comparison was done.
  97.  
  98.               virtual unsigned
  99.           hhhhaaaasssshhhh() const;
  100.  
  101.  
  102.      Redefined from class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee.  Calls RRRRWWWWCCCCSSSSttttrrrriiiinnnngggg::::::::hhhhaaaasssshhhh(((()))) and returns
  103.      the results.
  104.  
  105.               virtual RWClassID
  106.           iiiissssAAAA() const;
  107.  
  108.  
  109.      Redefined from class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee to return ________RRRRWWWWCCCCOOOOLLLLLLLLEEEECCCCTTTTAAAABBBBLLLLEEEESSSSTTTTRRRRIIIINNNNGGGG.
  110.  
  111.               virtual RWBoolean
  112.           iiiissssEEEEqqqquuuuaaaallll(const RWCollectable* c) const;
  113.  
  114.  
  115.      Redefined from class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee.  Calls RRRRWWWWCCCCSSSSttttrrrriiiinnnngggg::::::::ooooppppeeeerrrraaaattttoooorrrr========(((()))) (iiii....eeee....,
  116.      the equivalence operator) with cccc as the argument and returns the results.
  117.  
  118.               virtual void
  119.           rrrreeeessssttttoooorrrreeeeGGGGuuuuttttssss(RWvistream&);
  120.           virtual void
  121.           rrrreeeessssttttoooorrrreeeeGGGGuuuuttttssss(RWFile&);
  122.           virtual void
  123.           ssssaaaavvvveeeeGGGGuuuuttttssss(RWvostream&) const;
  124.           virtual void
  125.           ssssaaaavvvveeeeGGGGuuuuttttssss(RWFile&) const;
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg((((3333CCCC++++++++))))                            RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeeeSSSSttttrrrriiiinnnngggg((((3333CCCC++++++++))))
  137.  
  138.  
  139.  
  140.      Redefined from class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee.
  141.  
  142.               RWStringID
  143.           ssssttttrrrriiiinnnnggggIIIIDDDD();
  144.  
  145.  
  146.      (acts virtual) Inherited from class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.